home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 May / macformat-024.iso / Shareware City / Developers / kvik / src / README < prev    next >
Encoding:
Text File  |  1994-12-02  |  1.8 KB  |  54 lines  |  [TEXT/MPS ]
  1. kvik - A Kvikkalkul Compiler
  2. ----------------------------
  3.  
  4. Written by Asher Hoskins. (ukrhosk@prl.philips.co.uk)
  5.  
  6.  
  7.  
  8. To make the compiler, first tweak the Makefile if you don't have gcc, then
  9. type 'make'. Ignore the warning about OVERFLOW being redefined, this is a
  10. niggle which will get sorted out in the next release.
  11.  
  12. Now copy/move the files 'kvik_obj_header.h', 'kvik_obj_tail.h',
  13. 'kvik_obj_types.h', 'kc', 'kvik', and 'libkvik.a' to whatever directory
  14. you want to develop Kvikkalkul code in. 'make install' will copy these
  15. files to '../kviksrc'. The compiler expects to be in a directory parallel
  16. to the src directory (the code it generates references files in '../src').
  17.  
  18. To compile a program type 'kc <filename>'. To include a state dump in
  19. a compiled program give the name of the state dump after the main code
  20. filename.
  21.  
  22.  
  23. Notes on the compiler
  24. ---------------------
  25.  
  26. Labels are currently stored as integers, this means that leading zeros
  27. are ignored. This will get changed sometime... The maximum length of a label
  28. is four digits.
  29.  
  30. The numeric precision of the compiler is given at the top of the file
  31. 'text/library_routines'. 16-bits are used to store each number but the
  32. range is limited to 39999 values so that they tie in with decimal numbers
  33. more easily. (Look in the file kvikmath.c to see how it's done.)
  34.  
  35.  
  36. Any comments, etc. email me.
  37.  
  38. Asher.
  39.  
  40. --------------------------------------------------------------------
  41.  
  42. Note from the Portmeister:
  43.  
  44. Most of these instructions are useless. There is of course no libkvik.a
  45. file and I have moved the relevant runtime files into :kvik:runtime
  46. libs. C source is included so you can add AppleScript support if you 
  47. want.  I've also deleted the Makefile; I left kc in in case there's some
  48. way to translate it to MPW.  Of course, running kvikkalkul under MPW is 
  49. probably just plain silly...
  50.  
  51. Have loads of fun.
  52.  
  53. -Brian
  54.